Skip to content

Conversation

@fellyph
Copy link
Collaborator

@fellyph fellyph commented Oct 29, 2025

Motivation for the change, related issues

This pull request adds documentation for using Xdebug with IDE integration in the Playground CLI. The new section explains how to enable Xdebug with automatic IDE configuration for VSCode and PhpStorm, provides step-by-step setup instructions for each IDE, and describes path mappings and safety considerations. It also clarifies how to use Xdebug without IDE integration.

  • Added a new section detailing how to enable Xdebug with automatic IDE integration using the --xdebug and --experimental-unsafe-ide-integration flags, including a description of the automatic setup process and debug configuration creation.
  • Provided step-by-step instructions for setting up and using Xdebug with both VSCode and PhpStorm, including how to select a specific IDE for integration.
  • Added instructions for using Xdebug with Devtools integration, including manual configuration details for connecting the debugger.

The changes are a draft to have guidance on the content; images will be included once the content is mostly approved

@fellyph fellyph requested a review from adamziel October 29, 2025 22:18
@fellyph fellyph marked this pull request as ready for review November 4, 2025 19:02
@fellyph fellyph requested a review from mho22 November 4, 2025 19:03
@fellyph
Copy link
Collaborator Author

fellyph commented Nov 4, 2025

@adamziel The pages are ready for review

Copy link
Collaborator

@mho22 mho22 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great work! Thank you. I will implement the same path mapping approach for the @php-wasm/cli soon and copy paste your documentation for that specific case. I will need your approval of course.

Ah! And french version is perfect.

Clarify IDE integration description for Xdebug.
Updated formatting and added cautionary notes for IDE integration with Xdebug.
Copy link
Member

@brandonpayton brandonpayton left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thank you for adding this!

I think this is good overall, but the specific section on VS Code could be refined a bit more. I left a few comments below.

Updated IDE integration instructions for Xdebug, including safer plugin recommendations and added JSON configuration example.
@fellyph fellyph merged commit c91de71 into trunk Nov 6, 2025
25 checks passed
@fellyph fellyph deleted the add-xdebug-wasm-test-page branch November 6, 2025 07:03
@mho22
Copy link
Collaborator

mho22 commented Nov 6, 2025

🎉

@mho22 mho22 mentioned this pull request Nov 7, 2025
11 tasks
@adamziel
Copy link
Collaborator

adamziel commented Nov 10, 2025

Thank you @fellyph! A few notes:

  • That page is not accessible through any menu at the moment so no one can discover it. Let's make it available to the people
  • Can we de-emphasize the DevTools feature? It doesn't work well yet. Let's move it to the bottom or even to a separate page.
  • add PHP profiling support -> add PHP debugging support.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants